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Abstract 

The Faust Online Compiler is a PHP/JavaScript 
based web application that provides a cross-platform 
and cross-processor programming environment for the 
Faust language. It allows to use most of Faust fea¬ 
tures directly in a web browser and it integrates an 
editable catalog of examples making it a platform to 
easily share and use Faust objects. 
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think it is a pedagogical tool where it is possible 
to see in the most interactive way a digital sig¬ 
nal processing statement, its C++ equivalent, its 
diagram representation, its documentation and fi¬ 
nally its results. 

It has been implemented in the frame of the 
development of the new Faust website^ and it 
can be easily embedded in any HTML web page 
or installed on an Apache server. 

2 Interface 


1 Introduction 

Faust |0rlarey et al., 2002 1 is a functional pro¬ 
gramming language specifically designed for real¬ 
time signal processing and synthesis. Thanks to 
specific architecture files, a single FAUST pro¬ 
gram can be used to produce code for a variety 
of platforms and plug-in formats. These architec¬ 
ture files act as wrappers and describe the inter¬ 
actions with the host audio and GUI system. 

The Faust Online Compiler is a PHP/- 
JavaScript based web application that provides a 
cross-platform and cross-processor programming 
environment for the Faust language. It makes it 
possible to use most of Faust features directly in 
a web browser. In many ways, we think it is solv¬ 
ing one of Faust’s weakness: the great number 
of dependencies that using its architecture files in¬ 
volved. Indeed, even though Faust doesn’t need 
any specific library to be installed on a system to 
use it, some architecture files prove to be quite 
complicated to use because of their dependencies. 
It is also solving the system architecture issues 
that some Windows users, as an example, might 
have encountered in the past. 

The Faust Online Compiler integrates an 
editable catalog of examples making it a platform 
to easily share and use Faust objects. We also 


The Faust Online Compiler is a web applica¬ 
tion made of one fixed size block. Its size has been 
defined to fit in the new Faust website but it can 
be easily embedded and scaled to be adapted to 
any div of an HTML page using the iframe mech¬ 
anism (see [I]). A full page mode is also available 
to provide a more comfortable workspace. 

The navigation between the states of the Faust 
object is made through different tabs that can be 
selected in a navigation bar (see frame 1 in figure 

0 - 

2.1 Editing the code 

The Faust code in the Faust Online Compiler 
can be edited using two different ways. The most 
obvious one is by using the code editor that can 
be found in the Faust Code tab. The code editor 
CodeMirroi0 is used to carry out this task. It 
has been chosen because its compatibility with 
a great number of web browsers (Firefox, Safari, 
Opera, IE, Google Chrome, etc.). It uses a syntax 
highlighting specific to the Faust programming 
language. 

Thanks to an AJAX script the Faust Online 
Compiler also allows to drop any .dsp file con- 

: http: //faust. grame . f r/ 

"http://codemirror.net/ 
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"bandfilter"; 

" 1 . 0 "; 

"Grame"; 

"BSD"; 

"(c) GRAME 2006" 


declare name 
declare version 
declare author 
declare license 
declare copyright 

import ("math.lib"); 
import ( "music.lib" ); 

// .second order filter-- 

// filterlQ.F.G) 

// Q ; quality factor [1..100] 

frequency (Hz) 
gain [0..1] 


filter(Q,F,G) 


with { 
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V = db21inear(G); 

K = tan(PI*F/SR) ; 

D = 1 + V*K/Q + K*K; 


V 
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Figure 1: Overview of the compiler zone of the Faust Online Compiler. Frame 1 contains the 
navigation bar, frame 2 the compilation options and frame 3 the Faust code editor or the different kind 
of results of the compilation. 


taining a Faust program in the file drop area that 
is located just above the code editor (see figure 
[I]). This drop area is present in every tabs. This 
allows to compile a Faust code into many differ¬ 
ent elements in a very interactive way and very 
quickly. 


2.2 Compilation 

2.2.1 Compilation Options 


The compilation options menu can be found just 
under the navigation bar (see frame 2 in figure [TJ. 
It allows to set the kind of executable file that will 
be generated during the C++ compilation. Most of 
the Faust architectures can be used and the 0SC 
support option |Fober et ah, 2011| can be selected 
if it is allowed by the architecture. Further op¬ 
tions can be given to the Faust compiler by filling 
the Opts text area. 

The 64 bits Linux server (Ubuntu) that hosts 
the Faust Online Compiler at GRAME makes 
it possible to compile the C++ code generated by 
the Faust compiler in 32 or 64 bits for the fol¬ 
lowing platforms (in function of the selected ar¬ 


chitecture): 

• Linux 

• Windows using the MinGvj^] cross compiler 

• OSX 10.6 using the distant command execu¬ 
tion system of SSlQ 

If any of these options is changed in the C++ 
code or the Exec File tabs, the result will be 
automatically updated. 

2.2.2 Compilation 

In order to carry out the compilation, a tempo¬ 
rary folder containing the Faust file and a Make¬ 
file generated in function of the options given by 
the user and the architecture he selected is cre¬ 
ated on the server. It will be used by the Faust 
Online Compiler to generate the C++ code, the 
SVG diagram, the documentation, the executable 
hie and the different downloadable packages. 

'http://www.mingw.org/ 

J http://www.openssh.com/ 































Figure 2: Diagram of the server components. 


2.3 Getting the CH —\- Code 

If the C++ tab is selected, the Faust compiler is 
called on the server by the Makefile that will also 
use Highlight^] to color the generated C++ code. 

If the Faust code given by the user contains 
some errors, the message returned by the Faust 
compiler will be displayed instead of the C++ code. 
The Faust Online Compiler will react the 
same way in the case of the tabs SVG diagram 
and Automatic Doc. 
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Figure 3: Screenshot of the SVG Diagram tab. 
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Barkati et al., 2011 . The goals 


rematical documentation are: 


1. Preservation, i.e. to preserve signal proces¬ 
sors, independently from any computer lan¬ 
guage but only under a mathematical form; 


2.4 Displaying the SVG diagram of the 
Faust Code 

When the SVG Diagram button is clicked, in the 
same way than for the C++ code, the Makefile cre¬ 
ated on the server call the Faust compiler to gen¬ 
erate a SVG block diagram of the Faust code. The 
result is then displayed just under the file drop¬ 
ping area (see figure [3]) and can be browsed by 
clicking on the different boxes. 

2.5 Displaying the Mathematical 
Documentation of the Faust Object 

Some recent developments made at GRAME in 
the frame of the ASTREE project (see Acknowl¬ 
edgments) on the Faust compiler make it possible 
to generate automatically an all-comprehensive 
mathematical documentation of a Faust program 
under the form of a complete set of DTgX formu- 

“http://www.andre-simon.de/doku/highlight/en/ 
highlight.html 


2. Validation, i.e. to bring some help for de¬ 
bugging tasks, by showing the formulas as 
they are really computed after the compila¬ 
tion stage; 

3. Teaching, i.e. to give a new teaching support, 
as a bridge between code and formulas for 
signal processing; 

4. Publishing, i.e. to output publishing mate¬ 
rial, by preparing DTgX formulas and SVG 
block diagrams easy to include in a paper. 

The Faust Online Compiler is compatible 
with this function and can display the resulting 
pdf file using Google Document Vieweij^j The 
Makefile described in |2.3| is also used here to carry 
out the compilation process. 

A screen shot of the Automatic Doc tab can be 
seen in figure |4j 

( https : //docs . google . com/viewer/ 
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Figure 4: Screenshot of the Automatic Doc tab. 


2.6 Executable File 

When the Exec File button is clicked in the nav¬ 
igation bar, the C++ compilation is carried out in 
function of the platform and the processor archi¬ 
tecture selected. If this task is successful, a down¬ 
load button appear. Otherwise the error message 
returned by the C++ compiler is displayed. The 
downloadable file will be either an executable file 
either a package containing several files, in func¬ 
tion of the Faust architecture. 

3 Catalog of Examples 

The Faust Online Compiler has been up¬ 
graded with an interactive platform to easily share 
and use pieces of Faust code: the catalog of ex¬ 
amples. It is made of two elements: the catalog 
itself and the example saver. 

3.1 The Catalog 

The catalog has the form of a file browser where 
each Faust code is sorted into different categories 
(see figure [6]) : 

• Effects 

• Faust-STK [Michon and Smith, 2011 

• Synthesizers 

• Tools 

A set of “user” categories editable by the users 
were also created. 
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Figure 6: The catalog of examples of the Faust 
Online Compiler. 


When a Faust object is selected, a short de¬ 
scription and a screenshot of it are displayed in 
the Description column. The object can then 
be used in the online compiler either by double¬ 
clicking on it either by pushing the Choose it! 
button. 

The catalog of examples can be displayed in 
every tabs of the Faust Online Compiler. So, 
as an example, someone can choose just to see the 
block diagram of an object or its automatically 
generated documentation. 

3.2 The Example Saver 

As said before, the catalog of examples of the 
Faust Online Compiler is intended to be a 
platform to share Faust objects between users. 
This is made possible by the example saver (see 
figure [7]) that allows someone to save the Faust 
code he edited or he dropped within the catalog. 
No identification is required to carry out this task: 
anyone can freely upload his work in the catalog. 
When creating a new example, users can also add 
a quick description to their object as well as a 
screenshot. 

If an existing example is modified by a user dif¬ 
ferent than the one who created it, every users 
that contributed to this example will be notified 
by e-mail of the changes made in their Faust 
code. Finally, any user can freely delete exam¬ 
ples from the catalog. As in the case mentioned 
before, editors will be notified of this modification 
with an e-mail. 

In order to keep a good order in the catalog and 
to avoid duplicates or SPAMs, a voting system has 
been implemented. This can also help to promote 
the best user examples from the catalog. 
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Figure 5: Faust Online Compiler overview. 



Figure 7: The example saver of the Faust On¬ 
line Compiler. 

4 Exporting and embedding the Faust 
Online Compiler 

The Faust Online Compiler can be very easily 
embedded in any website using an iframe: 

Ciframe src="http://faust.grame.fr/ 
compiler" style="border:none" 
height = " 1200px" width="722px"></ 
iframe > 

It can also be installed on an Apache serveiQ 
just by copying the source code available on the 
Faust repository] on it. 

5 Current and Future Works 

Recent improvements on the Faust compiler al¬ 
low it to generate JAVA and LLVM code instead of 
C++ from a Faust code. This obviously brings to 
the idea of implementing a Faust architecture to 

'http://www.apache.org/ 

! 'http: //source forge . net/pro jects/f audiostream/ 


generate JAVA applets directly usable from a web 
browser. Thus, the Faust Online Compiler 
should soon be upgraded with a new tab running 
a web app generated in function of a Faust code 
edited in the Faust Code section. Our hope is 
that the JAVA applet will be updated almost in 
real time without having to restart it every time 
a change would be made. Therefore, this feature 
could offer some sort of live codding possibilities. 

As the Faust Online Compiler prove to be 
a good solution to the platform and dependen¬ 
cies issues related to the use of architecture files 
in Faust, it can be interesting to establish some 
links between it and the FaustWork^] program. 
In that special case, FaustWorks would be used 
to edit the Faust code and see its resulting dia¬ 
gram, C++ code, etc. but the compilation would 
be carried out on the server allowing it to generate 
Faust applications for any platforms, processors 
and architectures. 

6 Conclusion 

The Faust Online Compiler makes the Faust 
experience easier than ever by offering a program¬ 
ming environment ready to use and free from any 
installation and compatibility issues. 

It is certain that web technologies are having 
an increasingly important role in the domain of 
music technology. The arrival of new standards 

u FaustWorks is an IDE for Faust implemented with Qt. 









































like HTML5 or of new web-audio APIs is opening 
the way to new paths of exploration such as “Web 
Digital Signal Processing”. 
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